{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Language Exploration Using Vector Space Models"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Natural language processing is a huge sub-field of artificial intelligence that deals with models and representations for natural language.  A very common way to represent words, phrases, and documents in modern NLP involves the use of sparse vectors.  Here we'll explore a variety of Python libraries that implement various algorithoms related to natural language processing using vector space models."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "collapsed": true
   },
   "source": [
    "The first thing we need is some text to work with.  NLTK (Natural Language Toolkit) has many popular corpora available for download directly from the API, so let's use that.  For this exercise we're going to use the Brown corpus.  Start by initiating the download tool and selecting the corpus."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "%matplotlib inline\n",
    "import numpy as np\n",
    "import matplotlib.pyplot as plt\n",
    "import seaborn\n",
    "import nltk\n",
    "#nltk.download()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Check to make sure that the download was successful and we can access the data."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "1720901"
      ]
     },
     "execution_count": 2,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "from nltk.corpus import reuters\n",
    "len(reuters.words())"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "If you've never heard of the Reuters corpus, it's a collection of more than 10,000 news documents published in 1987 categorized into 90 different topics.  The content is obviously a bit dated but it's still interesting to work with because of the size of the collection and the fact that we have labeled topics for each document that we can use for certain types of supervised learning algorithms.  The corpus contains over 1.3 million words in total.\n",
    "\n",
    "NLTK's feature set is focused more on the linguistic aspect of natural language processing than the machine learning aspect, with functions for tasks such as tokenization, stemming, tagging, and parsing.  Even so, there are some very useful functions we can take advantage of to get a sense of what's in this corpus.  Let's start by tabulating the number of unique words in the corpus. "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "41600"
      ]
     },
     "execution_count": 3,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "vocabulary = set(reuters.words())\n",
    "len(vocabulary)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "There are 41,600 unique tokens in the corpus.  This doesn't tell us anything about the distribution of these tokens though.  NLTK has a built-in function to compute a frequency distribution for a text corpus."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "<FreqDist with 41600 samples and 1720901 outcomes>\n"
     ]
    }
   ],
   "source": [
    "fdist = nltk.FreqDist(reuters.words())\n",
    "print(fdist)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "[(u'.', 94687),\n",
       " (u',', 72360),\n",
       " (u'the', 58251),\n",
       " (u'of', 35979),\n",
       " (u'to', 34035),\n",
       " (u'in', 26478),\n",
       " (u'said', 25224),\n",
       " (u'and', 25043),\n",
       " (u'a', 23492),\n",
       " (u'mln', 18037),\n",
       " (u'vs', 14120),\n",
       " (u'-', 13705),\n",
       " (u'for', 12785),\n",
       " (u'dlrs', 11730),\n",
       " (u\"'\", 11272),\n",
       " (u'The', 10968),\n",
       " (u'000', 10277),\n",
       " (u'1', 9977),\n",
       " (u's', 9298),\n",
       " (u'pct', 9093),\n",
       " (u'it', 8842),\n",
       " (u';', 8762),\n",
       " (u'&', 8698),\n",
       " (u'lt', 8694),\n",
       " (u'on', 8556),\n",
       " (u'from', 7986),\n",
       " (u'cts', 7953),\n",
       " (u'is', 7580),\n",
       " (u'>', 7449),\n",
       " (u'that', 7377)]"
      ]
     },
     "execution_count": 5,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "fdist.most_common(30)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We can plot these cumulatively to get a sense for how much of the corpus they represent."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "image/png": [
       "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\n",
       "JUmSJEmlYhCWJEmSJJWKQViSJEmSVCoGYUmSJElSqRiEJUmSJEmlYhCWJEmSJJWKQViSJEmSVCoG\n",
       "YUmSJElSqRiEJUmSJEmlYhCWJEmSJJWKQViSJEmSVCoGYUmSJElSqRiEJUmSJEmlYhCWJEmSJJWK\n",
       "QViSJEmSVCoGYUmSJElSqRiEJUmSJEmlYhCWJEmSJJWKQViSJEmSVCoGYUmSJElSqRiEJUmSJEml\n",
       "YhCWJEmSJJWKQViSJEmSVCoGYUmSJElSqRiEJUmSJEmlYhCWJEmSJJWKQViSJEmSVCoGYUmSJElS\n",
       "qRiEJUmSJEmlYhCWJEmSJJWKQViSJEmSVCoGYUmSJElSqRiEJUmSJEmlYhCWJEmSJJWKQViSJEmS\n",
       "VCoGYUmSJElSqRiEJUmSJEmlYhCWJEmSJJWKQViSJEmSVCoGYUmSJElSqRiEJUmSJEmlYhCWJEmS\n",
       "JJWKQViSJEmSVCoGYUmSJElSqRiEJUmSJEmlYhCWJEmSJJWKQViSJEmSVCoGYUmSJElSqRiEJUmS\n",
       "JEmlYhCWJEmSJJWKQViSJEmSVCoGYUmSJElSqRiEJUmSJEmlYhCWJEmSJJWKQViSJEmSVCoGYUmS\n",
       "JElSqRiEJUmSJEmlYhCWJEmSJJWKQViSJEmSVCoGYUmSJElSqRiEJUmSJEmlYhCWJEmSJJWKQViS\n",
       "JEmSVCoGYUmSJElSqRiEJUmSJEmlYhCWJEmSJJWKQViSJEmSVCoGYUmSJElSqRiEJUmSJEmlYhCW\n",
       "JEmSJJWKQViSJEmSVCoGYUmSJElSqRiEJUmSJEmlYhCWJEmSJJWKQViSJEmSVCoGYUmSJElSqRiE\n",
       "JUmSJEmlYhCWJEmSJJWKQViSJEmSVCoGYUmSJElSqRiEJUmSJEmlYhCWJEmSJJWKQViSJEmSVCrN\n",
       "RTewM0VEI/DfwCSgFfhQSmlusV1JkiRJknqSehsRPhtoSSkdD3wC+ErB/UiSJEmSeph6C8Inuomm\n",
       "QQAAEfJJREFUADcDpJQeAI4sth1JkiRJUk/TUKlUiu5hp4mIy4FrU0o3Vx8/D+ybUuootjNJkiRJ\n",
       "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\n",
       "YII=\n"
      ],
      "text/plain": [
       "<matplotlib.figure.Figure at 0x1aa6dd68>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "fig, ax = plt.subplots(figsize=(16,12))\n",
    "ax = fdist.plot(30, cumulative=True)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Just 30 tokens make up around 35% of the entire corpus!  Moreover, most of these are things like punctuation and articles such as \"and\", \"to\", \"of\" and so on.  This is useful to know as we may want to strip out tokens like these.  You might also notice that the word 'the' appears on the list twice.  That's because the corpus contains both upper-case and lower-case words, and they are each counted separately.  Before we attempt to do anything with this data we'll need to correct these issues."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "30618"
      ]
     },
     "execution_count": 7,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "stopwords = nltk.corpus.stopwords.words()\n",
    "cleansed_words = [w.lower() for w in reuters.words() if w.isalnum() and w.lower() not in stopwords]\n",
    "vocabulary = set(cleansed_words)\n",
    "len(vocabulary)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "After converting everything to lowercase, removing punctuation, and removing \"stop words\" using a pre-defined list of words that do not add any semantic value, we've reduced the vocabulary from almost 42,000 to just over 30,000.  Note that we still didn't address things like singular vs. plural being different words.  To handle this we'd have to get into topics like stemming, but for not let's leave as-is.  Let's look at the top 30 again."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "[(u'said', 25383),\n",
       " (u'mln', 18623),\n",
       " (u'vs', 14341),\n",
       " (u'dlrs', 12417),\n",
       " (u'000', 10277),\n",
       " (u'1', 9977),\n",
       " (u'pct', 9810),\n",
       " (u'lt', 8696),\n",
       " (u'cts', 8361),\n",
       " (u'year', 7529),\n",
       " (u'net', 6989),\n",
       " (u'2', 6528),\n",
       " (u'billion', 5829),\n",
       " (u'loss', 5124),\n",
       " (u'3', 5091),\n",
       " (u'5', 4683),\n",
       " (u'would', 4673),\n",
       " (u'company', 4670),\n",
       " (u'1986', 4392),\n",
       " (u'4', 4363),\n",
       " (u'shr', 4182),\n",
       " (u'inc', 4121),\n",
       " (u'bank', 3654),\n",
       " (u'7', 3450),\n",
       " (u'corp', 3399),\n",
       " (u'6', 3376),\n",
       " (u'oil', 3272),\n",
       " (u'last', 3243),\n",
       " (u'8', 3218),\n",
       " (u'share', 3160)]"
      ]
     },
     "execution_count": 8,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "fdist = nltk.FreqDist(cleansed_words)\n",
    "fdist.most_common(30)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The list is arguably a bit more interesting now.  There's a lot more that we could do with NLTK, but since we're interested in using this data to build statistical models, we need to find ways to \"vectorize\" this data.  One common way to represent text data is called the \"bag of words\" representation.  A bag of words represents each document in a corpus as a series of features that ask a question about the document.  Most commonly, the features are the collection of all distinct words the vocabulary of the entire corpus.  The values are usually either binary (representing the presence or absence of that word in the document) or a count of the number of times that word appears in the document.  A corpus is then represented as a matrix with one row per document and one column per unique word.\n",
    "\n",
    "To build our initial bag of words matrix, we're going to use some of scikit-learn's built-in text processing capabilities."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "CountVectorizer(analyzer=u'word', binary=False, charset=None,\n",
       "        charset_error=None, decode_error=u'strict',\n",
       "        dtype=<type 'numpy.int64'>, encoding=u'utf-8', input=u'content',\n",
       "        lowercase=True, max_df=1.0, max_features=None, min_df=1,\n",
       "        ngram_range=(1, 1), preprocessor=None, stop_words='english',\n",
       "        strip_accents=None, token_pattern=u'(?u)\\\\b\\\\w\\\\w+\\\\b',\n",
       "        tokenizer=None, vocabulary=None)"
      ]
     },
     "execution_count": 9,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "from sklearn.feature_extraction.text import CountVectorizer\n",
    "vectorizer = CountVectorizer(stop_words='english')\n",
    "vectorizer"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We'll start off using scikit-learn's CountVectorizer class to transform our corpus into a sparse bag of words representation.  CountVectorizer expects as input a list of raw strings containing the documents in the corpus.  It takes care of the tokenization, transformation to lowercase, filtering stop words, building the vocabulary etc.  It also tabulates occurrance counts per document for each feature.\n",
    "\n",
    "Since CountVectorizer expects the raw data as input rather than the pre-processed data we were working with in NLTK, we need to create a list of documents to pass to the vectorizer."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "7769"
      ]
     },
     "execution_count": 10,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "files = [f for f in reuters.fileids() if 'training' in f]\n",
    "corpus = [reuters.raw(fileids=[f]) for f in files]\n",
    "len(corpus)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 11,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "u'BAHIA COCOA REVIEW\\n  Showers continued throughout the week in\\n  the Bahia cocoa zone, alleviating the drought since early\\n  January and improving prospects for the coming temporao,\\n  although normal humidity levels have not been restored,\\n  Comissaria Smith said in its weekly review.\\n      The dry period means the temporao will be late this year.\\n      Arrivals for the week ended February 22 were 155,221 bags\\n  of 60 kilos making a cumulative total for the season of 5.93\\n  mln against 5.81 at the same stage last year. Again it seems\\n  that cocoa delivered earlier on consignment was included in the\\n  arrivals figures.\\n      Comissaria Smith said there is still some doubt as to how\\n  much old crop cocoa is still available as harvesting has\\n  practically come to an end. With total Bahia crop estimates\\n  around 6.4 mln bags and sales standing at almost 6.2 mln there\\n  are a few hundred thousand bags still in the hands of farmers,\\n  middlemen, exporters and processors.\\n      There are doubts as to how much of this cocoa would be fit\\n  for export as shippers are now experiencing dificulties in\\n  obtaining +Bahia superior+ certificates.\\n      In view of the lower quality over recent weeks farmers have\\n  sold a good part of their cocoa held on consignment.\\n      Comissaria Smith said spot bean prices rose to 340 to 350\\n  cruzados per arroba of 15 kilos.\\n      Bean shippers were reluctant to offer nearby shipment and\\n  only limited sales were booked for March shipment at 1,750 to\\n  1,780 dlrs per tonne to ports to be named.\\n      New crop sales were also light and all to open ports with\\n  June/July going at 1,850 and 1,880 dlrs and at 35 and 45 dlrs\\n  under New York july, Aug/Sept at 1,870, 1,875 and 1,880 dlrs\\n  per tonne FOB.\\n      Routine sales of butter were made. March/April sold at\\n  4,340, 4,345 and 4,350 dlrs.\\n      April/May butter went at 2.27 times New York May, June/July\\n  at 4,400 and 4,415 dlrs, Aug/Sept at 4,351 to 4,450 dlrs and at\\n  2.27 and 2.28 times New York Sept and Oct/Dec at 4,480 dlrs and\\n  2.27 times New York Dec, Comissaria Smith said.\\n      Destinations were the U.S., Covertible currency areas,\\n  Uruguay and open ports.\\n      Cake sales were registered at 785 to 995 dlrs for\\n  March/April, 785 dlrs for May, 753 dlrs for Aug and 0.39 times\\n  New York Dec for Oct/Dec.\\n      Buyers were the U.S., Argentina, Uruguay and convertible\\n  currency areas.\\n      Liquor sales were limited with March/April selling at 2,325\\n  and 2,380 dlrs, June/July at 2,375 dlrs and at 1.25 times New\\n  York July, Aug/Sept at 2,400 dlrs and at 1.25 times New York\\n  Sept and Oct/Dec at 1.25 times New York Dec, Comissaria Smith\\n  said.\\n      Total Bahia sales are currently estimated at 6.13 mln bags\\n  against the 1986/87 crop and 1.06 mln bags against the 1987/88\\n  crop.\\n      Final figures for the period to February 28 are expected to\\n  be published by the Brazilian Cocoa Trade Commission after\\n  carnival which ends midday on February 27.\\n  \\n\\n'"
      ]
     },
     "execution_count": 11,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "corpus[0]"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Now we have the training corpus defined as a list of raw text documents.  We can pass this to our vectorizer to build our bag of words matrix."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 12,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<7769x26001 sparse matrix of type '<type 'numpy.int64'>'\n",
       "\twith 426016 stored elements in Compressed Sparse Row format>"
      ]
     },
     "execution_count": 12,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "X = vectorizer.fit_transform(corpus)\n",
    "X"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The vectorizer stores the data as a sparse matrix since a dense matrix would use way too much space and most of the values would be zero anyway (because each document only contains a small number of the total words in the vocabulary).  We can transform this to a numpy array if necessary though."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 13,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([[0, 0, 0, ..., 0, 0, 0],\n",
       "       [0, 3, 0, ..., 0, 0, 0],\n",
       "       [0, 0, 0, ..., 0, 0, 0],\n",
       "       ..., \n",
       "       [0, 0, 0, ..., 0, 0, 0],\n",
       "       [0, 0, 0, ..., 0, 0, 0],\n",
       "       [0, 2, 0, ..., 0, 0, 0]], dtype=int64)"
      ]
     },
     "execution_count": 13,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "X.toarray()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The vectorizer stores the feature names (words) that map to the matrix column indexes.  We can inspect those if desired.  Note that I'm skipping to index 2000 because if you look at the beginning of the index, it's all numbers!  The reuters corpus, being news articles, contains quite a high volume of numeric symbols.  It's debatable wether or not we should really include these in the vocabulary, but for now they're there."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 14,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "[u'aero',\n",
       " u'aeroe',\n",
       " u'aerojet',\n",
       " u'aeronautics',\n",
       " u'aeroperu',\n",
       " u'aerosol',\n",
       " u'aerosols',\n",
       " u'aerospace',\n",
       " u'aerotech',\n",
       " u'aet',\n",
       " u'aetna',\n",
       " u'afbf',\n",
       " u'affadavit',\n",
       " u'affair',\n",
       " u'affairs',\n",
       " u'affandi',\n",
       " u'affect',\n",
       " u'affected',\n",
       " u'affecting',\n",
       " u'affects',\n",
       " u'affiliate',\n",
       " u'affiliated',\n",
       " u'affiliates',\n",
       " u'affiliation',\n",
       " u'affinerie',\n",
       " u'affirmation',\n",
       " u'affirmative',\n",
       " u'affirmed',\n",
       " u'afflicted',\n",
       " u'afford']"
      ]
     },
     "execution_count": 14,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "vectorizer.get_feature_names()[2000:2030]"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "One potential issue with this representation is that it holds an in-memory mapping of the vocabulary to the document matrix that can get unwieldy on large datasets.  This approach also doesn't work when training in an on-line fashion since it needs to build the entire vocabulary ahead of time.  There's another vectorization algorithm implemented in scikit-learn that uses feature hashing to build the matrix in a stateless manner.  This HashingVectorizer class solves both of the above problems, however is comes with some tradeoffs - it's not possible to \"inverse transform\" the vector back to the original words, and there's a possibility of collisions that could cause some information to be lost."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 15,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<7769x1048576 sparse matrix of type '<type 'numpy.float64'>'\n",
       "\twith 573305 stored elements in Compressed Sparse Row format>"
      ]
     },
     "execution_count": 15,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "from sklearn.feature_extraction.text import HashingVectorizer\n",
    "hv = HashingVectorizer()\n",
    "X_hash = hv.transform(corpus)\n",
    "X_hash"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "For now we'll continue using the count vectorizer, but for very large corpora this approach would be faster and more efficient.\n",
    "\n",
    "We now have a bag of words matrix, however there's another problem - some words appear much more frequently across the corpora as a whole than other words, so their presence in a document should carry less weight than a word that is very infrequent in general.  To adjust for this, we'll use something called TF-IDF weighting.  TF stands for term frequency, while IDF stands for inverse document frequency.  The TF-IDF calculation lowers the relative weight of common words and increases the relative weight of uncommon words.\n",
    "\n",
    "Scikit-learn implements TF-IDF as a separate transform that we can apply to the output of our vectorizer."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 16,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "TfidfTransformer(norm=u'l2', smooth_idf=True, sublinear_tf=False,\n",
       "         use_idf=True)"
      ]
     },
     "execution_count": 16,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "from sklearn.feature_extraction.text import TfidfTransformer\n",
    "tfidf = TfidfTransformer()\n",
    "tfidf"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 17,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([[ 0.        ,  0.        ,  0.        , ...,  0.        ,\n",
       "         0.        ,  0.        ],\n",
       "       [ 0.        ,  0.0802965 ,  0.        , ...,  0.        ,\n",
       "         0.        ,  0.        ],\n",
       "       [ 0.        ,  0.        ,  0.        , ...,  0.        ,\n",
       "         0.        ,  0.        ],\n",
       "       ..., \n",
       "       [ 0.        ,  0.        ,  0.        , ...,  0.        ,\n",
       "         0.        ,  0.        ],\n",
       "       [ 0.        ,  0.        ,  0.        , ...,  0.        ,\n",
       "         0.        ,  0.        ],\n",
       "       [ 0.        ,  0.18269601,  0.        , ...,  0.        ,\n",
       "         0.        ,  0.        ]])"
      ]
     },
     "execution_count": 17,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "X_weighted = tfidf.fit_transform(X)\n",
    "X_weighted.toarray()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Now that we have a weighted term-document matrix, let's do something with it.  A common natural language processing task is to classify documents as belonging to a particular category.  Since the reuters corpus is labeled, we can used a supervised learning algorithm to attempt to learn how to categorize similar news articles.\n",
    "\n",
    "To do this we need a few additional pieces of information.  We need a set of labels, and we need a test set to evaluate performance of the model.  Forunately we have both available to us for the reuters dataset."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 18,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "# build the term-document matrix for the test set using the existing transforms\n",
    "test_files = [f for f in reuters.fileids() if 'test' in f]\n",
    "test_corpus = [reuters.raw(fileids=[f]) for f in test_files]\n",
    "X_test = vectorizer.transform(test_corpus)\n",
    "X_test_weighted = tfidf.transform(X_test)\n",
    "\n",
    "# get the categories for each document in both the train and test sets\n",
    "train_labels = [reuters.categories(fileids=[f]) for f in files]\n",
    "test_labels = [reuters.categories(fileids=[f]) for f in test_files]"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Since there are 90 distinct categories, and each document can be assigned to more than one category, we probably don't have enough documents per category to build a really good document classifier.  We're going to simplify the problem a bit and reduce the classification to a binary problem - wether or not the document belongs to the 'acq' category."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 19,
   "metadata": {
    "collapsed": false
   },
   "outputs": [],
   "source": [
    "y = np.asarray([1 if 'acq' in label else 0 for label in train_labels])\n",
    "y_test = np.asarray([1 if 'acq' in label else 0 for label in test_labels])"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 20,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "((7769, 26001), (7769L,), (3019, 26001), (3019L,))"
      ]
     },
     "execution_count": 20,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "X_weighted.shape, y.shape, X_test_weighted.shape, y_test.shape"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Now we're ready to train a classifier.  We'll use multinomial Naive Bayes in this example."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 21,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "             precision    recall  f1-score   support\n",
      "\n",
      "    not acq       0.87      1.00      0.93      2300\n",
      "        acq       0.99      0.52      0.68       719\n",
      "\n",
      "avg / total       0.90      0.88      0.87      3019\n",
      "\n"
     ]
    }
   ],
   "source": [
    "from sklearn.naive_bayes import MultinomialNB\n",
    "from sklearn.metrics import classification_report\n",
    "\n",
    "# train the classifier\n",
    "classifier = MultinomialNB()\n",
    "classifier.fit(X_weighted, y)\n",
    "\n",
    "# predict labels for the test set\n",
    "predictions = classifier.predict(X_test_weighted)\n",
    "\n",
    "# output the classification report\n",
    "label_names = ['not acq', 'acq']\n",
    "print(classification_report(y_test, predictions, target_names=label_names))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "So that's a pretty reasonable outcome, although the recall is not as high as we would like it to be.  There are a number of ways we could work to improve this result, such as experimenting with removing extraenous tokens such as numbers from our vocabulary or constructing additional high-level features about the documents.  For a simple bag-of-words model though it's not too bad.\n",
    "\n",
    "Supervised learning is nice when we have a labeled dataset, but the vast majority of text in the wild does not come with any sort of label so its usefulness in natural language processing is often limited.  What about unsupervised techniques to categorize documents?  Scikit-learn packages a decomposition technique called non-negative matrix factorization (NMF) that we can use for topic extraction."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 22,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Topic #0:\n",
      "loss profit vs 000 cts dlrs oper shr revs year qtr 4th includes net discontinued note operations 1986 quarter excludes\n",
      "\n",
      "Topic #1:\n",
      "pct february january rose year rise rate index december prices 1986 inflation said fell compared growth consumer statistics base production\n",
      "\n",
      "Topic #2:\n",
      "cts qtly div record april pay prior vs dividend sets march quarterly lt payout 15 10 payable regular 30 31\n",
      "\n",
      "Topic #3:\n",
      "said trade japan dollar bank yen japanese exchange foreign rates market rate dealers economic currency paris countries nations government told\n",
      "\n",
      "Topic #4:\n",
      "vs mln 000 net cts shr revs qtr avg shrs oper dlrs note profit 4th lt year mths 31 sales\n",
      "\n",
      "Topic #5:\n",
      "billion dlrs surplus deficit mln francs marks 1986 january year rose february reserves trade fell 1985 account foreign december exports\n",
      "\n",
      "Topic #6:\n",
      "fed customer repurchase says reserves federal agreements funds reserve temporary sets dlrs week repurchases securities economists supply billion add trading\n",
      "\n",
      "Topic #7:\n",
      "stg mln bank money market england bills band assistance shortage revised today forecast help given provided 16 estimate compares central\n",
      "\n",
      "Topic #8:\n",
      "tonnes 000 wheat sugar corn export said ec grain 87 traders 1986 maize production tonne exports year soviet usda china\n",
      "\n",
      "Topic #9:\n",
      "dlrs said mln company shares share stock lt corp offer split common quarter group earnings dividend oil board shareholders unit\n",
      "\n"
     ]
    }
   ],
   "source": [
    "from sklearn.decomposition import NMF\n",
    "nmf = NMF(n_components=10).fit(X_weighted)\n",
    "\n",
    "feature_names = vectorizer.get_feature_names()\n",
    "\n",
    "for topic_idx, topic in enumerate(nmf.components_):\n",
    "    print('Topic #%d:' % topic_idx)\n",
    "    print(' '.join([feature_names[i] for i in topic.argsort()[:-20 - 1:-1]]))\n",
    "    print('')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The above output takes the components derived from the factorization (here assumed to model a \"topic\" from the corpus) and extracts the 20 words that most significantly contributed to that topic.  Although it's not perfect, we can see some commonalites among the groups of words.\n",
    "\n",
    "NMF gives some interesting results, but there are more advanced algorithms for topic modeling.  Latent Dirichlet Allocation (LDA), for example, is a technique that models documents as though they are composed of some undefined number of topics.  Each of the words in the document are then said to be attributed to some combination of those topics.  \n",
    "\n",
    "Scikit-learn does not implement LDA so if we want to try it out, we'll need to look elsewhere.  Fortunately there's a library called gensim that's focused specifically on topic modeling.  To start off we need our corpus in a format that gensim models can use as input.  Gensim implements a lot of the same transforms that we just applied to the data, but rather that re-create the same transforms we can re-use what we've already done and convert our term-document matrix into gensim's expected format."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 23,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "WARNING:gensim.models.ldamodel:no word id mapping provided; initializing from corpus, assuming identity\n"
     ]
    },
    {
     "data": {
      "text/plain": [
       "<gensim.models.ldamodel.LdaModel at 0x20e99fd0>"
      ]
     },
     "execution_count": 23,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "from gensim import corpora, models, similarities, matutils\n",
    "\n",
    "# create the corpus using a conversion utility\n",
    "gensim_corpus = matutils.Sparse2Corpus(X_weighted)\n",
    "\n",
    "# build the LDA model\n",
    "lda = models.LdaModel(gensim_corpus, num_topics=100)\n",
    "lda"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "With our LDA model we could now examine the words that most contribute to each topic (as we did with NMF), or we could compare new documents to the model to identify either the topics that make up that document or the existing documents that they are most similar to.  However, I want to move on from NMF/LDA to another algorithm implemented in gensim called word2vec because it's really, really interesting.  Word2vec is an unsupervised neural network model that runs on a corpus of text and learns vector representations for the individual words in the text.  The word vectors are modeled in a way such that words that are semantically \"close\" to each other are also close in a mathematical sense, and this results in some interested properties.  Let's explore some of the implications on the reuters dataset.\n",
    "\n",
    "Since word2vec expects a list of sentences as input, we'll need to go back to the pre-transformed sentence list provided by NLTK."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 24,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "model = models.Word2Vec(reuters.sents(), size=100, window=5, min_count=5, workers=4)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We now have a trained word2vec model.  It's possible to look at the vector for a word directly, although it won't mean much to a person."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 25,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([ 0.36218089,  0.04660718, -0.03312639, -0.00589092,  0.08425491,\n",
       "       -0.05584015,  0.39824656, -0.19913128,  0.21185778, -0.16018888,\n",
       "       -0.30720046,  0.41359827,  0.05477867,  0.40744004, -0.15048127,\n",
       "       -0.21775401, -0.0918686 ,  0.08254269, -0.36109206, -0.08484149,\n",
       "       -0.37724456,  0.19134018,  0.18765855,  0.17301551, -0.13106611,\n",
       "        0.10278706,  0.14409529,  0.09305458, -0.27449781, -0.16971849,\n",
       "        0.20959041,  0.12159102,  0.07963905,  0.03050068,  0.31353745,\n",
       "        0.06859812, -0.26051152,  0.1805039 ,  0.28199297, -0.19140336,\n",
       "        0.13152425,  0.04389969,  0.06004116, -0.31306067, -0.12013798,\n",
       "       -0.17255786, -0.05460097, -0.35606486,  0.31404966,  0.03737779,\n",
       "       -0.11519474,  0.31271645, -0.31853175,  0.08142728,  0.09033886,\n",
       "       -0.15671426, -0.07798025,  0.06073617,  0.2294289 ,  0.13113637,\n",
       "       -0.04398542, -0.34159404,  0.06506728,  0.20032322, -0.11604583,\n",
       "       -0.14258914, -0.06725569, -0.06181487,  0.13476266,  0.17378812,\n",
       "        0.01733109, -0.0836978 , -0.24637276,  0.06484974, -0.02348729,\n",
       "        0.27839953, -0.12627478,  0.50229609,  0.02701729, -0.11646958,\n",
       "       -0.3040815 , -0.18003054,  0.01555716, -0.11430902, -0.40754062,\n",
       "        0.05430043,  0.27255279,  0.12115923,  0.16014519, -0.03295279,\n",
       "       -0.50409102,  0.38960707, -0.19293144, -0.19752754, -0.14633107,\n",
       "        0.24427678, -0.13369191,  0.18097162, -0.26153758, -0.11974742], dtype=float32)"
      ]
     },
     "execution_count": 25,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "model['market']"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Every word in the vocabulary now has a vector representation that looks like this.  Since we're dealing with vectors, it's possible to compare words using vector math such as the cosine similarity."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 26,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "0.7455091131291105"
      ]
     },
     "execution_count": 26,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "model.similarity('dollar', 'yen')"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 27,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "0.28685558842610581"
      ]
     },
     "execution_count": 27,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "model.similarity('dollar', 'potato')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "According to the model, 'dollar' and 'yen' are much more similar to each other (both being currencies) than 'dollar' and 'potato'.  The relationship is deeper than just a similarity measure though.  The word2vec model is capable of capturing abstract concepts as well.  The ubiquitous example is \"woman + king - man = queen\".  When properly trained on a large enough amount of text, the model is able to detect that the relationship between 'woman' and 'queen' is similar to the relationship between 'man' and 'king'.  Let's see if the model we just trained can do something similar."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 28,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "[(u'appreciation', 0.6466031670570374),\n",
       " (u'appreciated', 0.596366822719574),\n",
       " (u'sterling', 0.5693594813346863),\n",
       " (u'Taiwan', 0.5512674450874329),\n",
       " (u'slowly', 0.5457212924957275),\n",
       " (u'mark', 0.5433770418167114),\n",
       " (u'yen', 0.5293248891830444),\n",
       " (u'stems', 0.5171161890029907),\n",
       " (u'pleas', 0.5137792825698853),\n",
       " (u'brake', 0.5080464482307434)]"
      ]
     },
     "execution_count": 28,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "model.most_similar(positive=['Japan', 'dollar'], negative=['US'])"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "It didn't get it exactly right, although 'yen' is on the list, but there's a lot of other noise too.  This is mostly likely due to the relatively small size of the dataset.  Word2vec needs a huge amount of training data to work really well.  Some parameter tuning might help too - for example, a size of 100 dimensions might be way too big for the amount of data in the reuters dataset.\n",
    "\n",
    "Let's see if there's a way to visualize some of the information captured by the model.  Since the vectors are high-dimensional we can't visualize them directly, but we can apply a dimension reduction technique like PCA and use the first two principal components as coordinates.  We can try this with a group of words that should be somewhat similar, such as countries."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 29,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "image/png": [
       "iVBORw0KGgoAAAANSUhEUgAAA6sAAALACAYAAAB1puSoAAAABHNCSVQICAgIfAhkiAAAAAlwSFlz\n",
       "AAALEgAACxIB0t1+/AAAIABJREFUeJzs3Xv833P9//H757PNZvbZpD4y25i+8RJ+EiEMOWzIaUM5\n",
       "F8NQcliFRCqnKOdUDmM5JlGJ0FCKr6/4KhF7MceZDhO2MbPT5/fHZt+dTPt8dnjyuV4vl136vF+H\n",
       "9/v5/jzm0m6f9+v9/jS0tLQEAAAAStK4tBcAAAAAcxOrAAAAFEesAgAAUByxCgAAQHHEKgAAAMUR\n",
       "qwAAABSnY1tOrqpq4yTfret6q7m2H5PkoCRjZ246tK7rJ9vyWAAAALQfrY7VqqqOTbJfktfns3v9\n",
       "JPvXdf3n1t4/AAAA7VdbLgMelWS3JA3z2bdBkhOqqvpjVVXHt+ExAAAAaIdaHat1Xd+UZOo77L4u\n",
       "yaFJtk7Sr6qqHVv7OAAAALQ/bXrP6gKcX9f1+CSpqurWJJ9Icus7HdzS0tLS0DC/F2gBAAB4H1jo\n",
       "4FvksVpVVY8kf62qaq0kEzPj1dVhCzqnoaEhY8dOWNRLoRWam5vMohBmURbzKIdZlMMsymEW5TCL\n",
       "sphHOZqbmxb6nEURqy1JUlXV3km61XV96cz3qf4uyVtJ7qzr+vZF8DgAAAC0E22K1bqun0uy6cyv\n",
       "r5tt+3WZ8b5VAAAAWGht+TRgAAAAWCzEKgAAAMURqwAAABRHrAIAAFAcsQoAAEBxxCoAAADFEasA\n",
       "AAAUR6wCAABQHLEKAABAccQqAAAAxRGrAAAAFEesAgAAUByxCgAAQHHEKgAAAMURqwAAABRHrAIA\n",
       "AFAcsQoAAEBxxCoAAADFEasAAAAUR6wCAABQHLEKAABAccQqAAAAxRGrAAAAFEesAgAAUByxCgAA\n",
       "QHHEKgAAAMURqwAAABRHrAIAAFAcsQoAAEBxxCoAAADFEasAAAAUR6wCAABQHLEKAABAccQqAAAA\n",
       "xRGrAAAAFEesAgAAUByxCgAAQHHEKgAAAMURqwAAABRHrL6HTZ06NVddNTz77LN7tt560+y884B8\n",
       "61vfyJgxL7b5vh9++KFsvvmGmTRp0n90/KhRT+Xhhx9q8+MCAAAkYvU97ZJLLsqtt96co476aq69\n",
       "9qacdda5mThxYr70pUPy+uuvt+m+1113vdx88x3p0qXLf3T817/+lTz33LNtekwAAIC3idX3sFtv\n",
       "vTmDBw/JxhtvkpVWWikf+9jaOeWUM/LGG2/kj3/8fZvuu2PHjvnAB1ZYqHNaWlra9JgAAABvE6vv\n",
       "YQ0NjXnooQcybdq0Wds6d+6S4cOvzRZbfDpJctddv80XvrB3ttlms+yzz+657bZbkiRjxryYzTff\n",
       "ME8/PWrWuVOnTs3GG2+cu+++c57LgP/975dz0knHZ8CALbPrrtvnzDNPzRtvzHj19ogjhuQf//h7\n",
       "zjvveznyyMOW0LMHAADez8Tqe9hee+2b2267Jbvt9pmcfvq3c9ttt+TVV19Jr169s9xy3TJixO05\n",
       "7bRvZdCgPXLllddn9933zFlnnZb77783vXr1zlprrZO77x4x6/4efPB/MmXKlPTrt8U8j/WNbxyb\n",
       "xsaGXHzxFTnzzHMzZsyLOfnkE5Ikp5/+/TQ3r5hDD/1STjvte0vs+QMAAO9fHZf2Ami9/fY7IH36\n",
       "rJJf/OLnGTHi9tx22y1pbGzMoEF75Mgjv5Kf/vSa7LLLoAwcuHuSZPfdP5dnn30mV155RTbZpF/6\n",
       "998uN910Qw455PAkyV13jUj//v2zzDLLzPE4Dz/8UJ5+elR+8INL0rHjjL8y3/zmKRk06DN57rln\n",
       "07fvaunQoUO6dl0uTU1NS/abAAAAvC+J1fe4LbfcOltuuXUmTZqUhx9+KLfffmtuvPFn+eAHm/P8\n",
       "889mr732neP4ddf9eO68844kydZb98+FF56bUaOeyiqrrJp77/1Dzjvv3Hke49lnn85bb03KDjts\n",
       "Pcf2hoaGPP/8c+nbd7XF9wQBAIB2Say+R40a9VRuueVXOfroryZJunTpkk037ZdNN+2Xk09uyJ/+\n",
       "dH+WWabzPOdNnz4906dPT5KssMIHs8EGG+Wuu36btddeJ506dcpmm22Wf//7jTnOmTZtWj784Z45\n",
       "77yL5rm/hf0QJgAAgP+E96y+R02fPi033nh9/va3x+bZ17Xrcll++Q9k1VX75tFHH5lj32OP/XWO\n",
       "V0IHDNg+9933h/zhD7/P1ltvm8bGef9KrLrqavn3v8dm2WWXTa9evdOrV+906NAx559/dl577dWZ\n",
       "RzUs0ucHAAC0b2L1PWqNNdbMlltulRNO+GpuvfXmjBnzYp56qs61116VO++8PXvttV/22++A3HLL\n",
       "r/LLX96Y0aNfyE033ZBbb705n/3sXrPuZ4sttsqYMS/m97+/O/37bz/fx9poo0+lb9+P5Jvf/HpG\n",
       "jnwiTz1V55RTTsq//vXP9Oy5cpKka9dl89xzz+TVV1+d730AAAAsDJcBv4edfPJpufbaK/PTn16d\n",
       "c889K42NHbL22uvk7LMvzNprr5MkGTr0uFx99U9ywQVnp3fvPjn++JPmiNKuXbumX78t8sQTj2ed\n",
       "ddad4/4bGhpm/e+ZZ56T88//fo466rA0NDTmk5/cKN/+9umzjvnsZ/fKD35wXh577NFcfvnVS+g7\n",
       "AAAAvF81tLS0LO01JEnL2LETlvYaSNLc3BSzKINZlMU8ymEW5TCLcphFOcyiLOZRjubmpoV+36DL\n",
       "gAEAACiOWAUAAKA4YhUAAIDiiFUAAACKI1YBAAAojlgFAACgOGIVAACA4ohVAAAAiiNWAQAAKI5Y\n",
       "BQAAoDhiFQAAgOKIVQAAAIojVgEAACiOWAUAAKA4YhUAAIDiiFUAAACKI1YBAAAojlgFAACgOGIV\n",
       "AACA4ohVAAAAiiNWAQAAKI5YBQAAoDhiFQAAgOKIVQAAAIojVgEAAChOm2K1qqqNq6r63Xy271xV\n",
       "1Z+qqvrvqqoObstjAAAA0P60Olarqjo2yaVJOs+1vVOSc5L0T7JlkiFVVa3YlkUCAADQvrTlldVR\n",
       "SXZL0jDX9o8lGVXX9bi6rqckuTfJFm14HAAAANqZVsdqXdc3JZk6n13dk4yb7faEJD1a+zgAAAC0\n",
       "Px0Xw32OS9I02+2mJK++20nNzU3vdghLiFmUwyzKYh7lMItymEU5zKIcZlEW83jvWhyxOjLJ6lVV\n",
       "fSDJG5lxCfD33u2ksWMnLIalsLCam5vMohBmURbzKIdZlMMsymEW5TCLsphHOVrzQ4NFEastSVJV\n",
       "1d5JutV1fWlVVUOT3JEZlxkPq+v674vgcQAAAGgn2hSrdV0/l2TTmV9fN9v2W5Lc0qaVAQAA0G61\n",
       "6fesAgAAwOIgVgEAACiOWAUAAKA4YhUAAIDiiFUAAACKI1YBAAAojlgFAACgOGIVAACA4ohVAAAA\n",
       "iiNWAQAAKI5YBQAAoDhiFQAAgOKIVQAAAIojVgEAACiOWAUAAKA4YhUAAIDiiFUAAACKI1YBAAAo\n",
       "jlgFAACgOGIVAACA4ohVAAAAiiNWAQAAKI5YBQAAoDhiFQAAgOKIVQAAAIojVgEAACiOWAUAAKA4\n",
       "YhUAAIDiiFUAAACKI1YBAAAojlgFAACgOGIVAACA4ohVAAAAiiNWAQAAKI5YBQAAoDhiFQAAgOKI\n",
       "VQAAAIojVgEAACiOWAUAAKA4YhUAAIDiiFUAAACKI1YBAAAojlgFAACgOGIVAACA4ohVAAAAiiNW\n",
       "AQAAKI5YBQAAoDhiFQAAgOKIVQAAAIojVgEAACiOWAUAAKA4YhUAAIDiiFUAAACKI1YBAAAojlgF\n",
       "AACgOGIVAACA4ohVAAAAiiNWAQAAKI5YBQAAoDhiFQAAgOKIVQAAAIojVgEAACiOWAUAAKA4YhUA\n",
       "AIDiiFUAAACKI1YBAAAojlgFAACgOGIVAACA4ohVAAAAiiNWAQAAKI5YBQAAoDhiFQAAgOKIVQAA\n",
       "AIojVgEAACiOWAUAAKA4YhUAAIDidGzNSVVVNSb5YZJ1k7yV5OC6rp+ebf8xSQ5KMnbmpkPrun6y\n",
       "jWsFAACgnWhVrCYZmGSZuq43rapq4yRnz9z2tvWT7F/X9Z/bukAAAADan9ZeBrxZktuTpK7rB5J8\n",
       "cq79GyQ5oaqqP1ZVdXwb1gcAAEA71NpY7Z5k/Gy3p828NPht1yU5NMnWSfpVVbVjKx8HAACAdqi1\n",
       "lwGPT9I02+3Guq6nz3b7/LquxydJVVW3JvlEklsXdIfNzU0L2s0SZBblMIuymEc5zKIcZlEOsyiH\n",
       "WZTFPN67Whur9yXZOckNVVV9Kslf395RVVWPJH+tqmqtJBMz49XVYe92h2PHTmjlUliUmpubzKIQ\n",
       "ZlEW8yiHWZTDLMphFuUwi7KYRzla80OD1sbqL5L0r6rqvpm3D6yqau8k3eq6vnTm+1R/lxmfFHxn\n",
       "Xde3t/JxAAAAaIdaFat1XbckOXyuzU/Otv+6zHjfKgAAACy01n7AEgAAACw2rb0MGAAAgNlMmTIl\n",
       "P/vZtRkx4o6MGfNiGhoasvrqa2SPPfbMVlttu7SX954jVgEAANpo8uTJOeqowzJ+/PgMHjwka6/9\n",
       "/zJ58lu5994/5NRTT864ceMycODuS3uZ7yliFQAAoI2uuuqKvPjii7nmmhvSvXuPWdv32advOnfu\n",
       "nCuuuCS77rpbGhoaluIq31u8ZxUAAKANpk+fnptv/kX23nu/OUL1bTvtNDCXX35NGhoaMnHiGznz\n",
       "zNPymc9skx133CYnnXR8Xn755VnHbr75hrnssh9nl122y4EH7pMxY17M5ptvmPvvvy977TUo227b\n",
       "L9/85tfzz3/+I8cfPzTbbtsv++33uTz22KOz7uOBB+7PkCEHZJttNsu22/bLUUcdntGjX0iS/P3v\n",
       "L2XzzTfM739/V/bZZ/dsvfVm+eIXD84LLzyfJPnqV4/MKad8c471Dxt2cY44Ysji+NYtkFgFAABo\n",
       "g5deGpNXXvl31ltv/fnu79y5cz74wQ8lSc4887S89NKLOffci/KDH1yahoaGfOUrR2T69Omzjr/z\n",
       "zt/mwgsvzje+8e00Ns5Itssvvzjf+c4ZOfPMc/PHP/4+Bx20f7bccutcdtlVWXHFFXPOOWcmmRGj\n",
       "X//6V7LNNv1zzTU/z/nn/zjjx4/LD394/hxrGj58WI4//qRcdtlPMm7ca/nRjy5Ikmy33Wdy7733\n",
       "ZPLkybOOHTHijmy33WcW3TfsPyRWAQAA2uC1115NkvTosfysba+++kr69988/ftvMevPX/7ycO6+\n",
       "e0ROOumUVNWaWW21j+TEE7+dv//973nggftnnbvLLgOz6qp989GPrj5r2/77D84aa6yZDTbYMKuv\n",
       "XmXdddfLDjvslL59V8tOOw3Mc889kySZNm1avvSlo7PnnvtmpZV6Zu2118mAAZ/JM888PceaP//5\n",
       "wVl33fXykY98NIMG7ZEnnng8SbL55p9OS0ty//33JUlGjnw8//rXP5bKB0R5zyoAAEAbdO/ePUky\n",
       "YcL4Wdt69Fg+w4dflySZNGlSDjhg70ycODFJsvfeu81x/uTJb+WFF57LJptsliRZeeVe8zzG7Ns6\n",
       "d+48z+0pU6YkSXr37pMuXbrkmmt+kmeffSYvvPB8Ro16Mh/8YPMc99enT59ZX3ftulymTp2aJOnS\n",
       "pUu23HKr3H33b7PllltlxIg7sskmm6Vbt24L+V1pO7EKAADQBiuv3Ds9eiyfv/71L1lzzbWSJI2N\n",
       "jenVq3eSzIrUadOmpmPHjhk+/Np57qOpqfusrzt37jzP/g4dOsxxu7Fx/h/U9PTTo3L44Qdlo402\n",
       "znrrrZ+ddx6Yv/3t0fziFz+f47iOHTvNdWbLrK8GDNghJ5zw1UyaNCl33z0iRx/9tXd45ouXy4AB\n",
       "AADaoGPHjtlll0H56U+vyfjx4+bZP3bsv5Ikr7zySqZOnZo33ng9vXr1Tq9evbPCCh/MhReekxdf\n",
       "fGGRrOXmm2/KGmtUOfXUs7LHHnvl4x//RF566aW0tLS8+8kzbbDBhlluuW655pqf5M0338xmm22+\n",
       "SNa2sMQqAABAGw0ePCR9+qyaQw75Qm6//da8+OLoPPvsM7nqquE59NADs9JKK2fjjTdJv35b5NRT\n",
       "T84jj/w5zz//XE499Zup65Hp23e1//ixWlpa8k7t2dy8Yp5//rk88shfMmbMi7n++mtyxx2/yZQp\n",
       "k+d/wnw0Njamf//tc+21V2arrbZNx45L54JclwEDAAC0UceOHXPuuT/Ir351U2666Yacd973Mm3a\n",
       "tPTtu1q+8IWDMmjQHunSpUu+8Y1v58ILz8kJJ3w1U6ZMzTrrrJvzzvthunZd7h3ve+7fzdrQ0JC5\n",
       "f13r28d89rN75emnR+W4445JQ0NDNt98y5x11rk5+ugv5uWXx77j/SVzbtt22+3y059enQEDtm/l\n",
       "d6TtGhbm5eDFqGXs2AlLew0kaW5uilmUwSzKYh7lMItymEU5zKIcZlEW82i9//7ve3P22d/NjTfe\n",
       "skjur7m5af5vsl0Ar6wCAACQZMbvaX388b9l+PBLs+uuu737CYuR96wCAACQJPnnP/+R7373lHz4\n",
       "wytlzz33Xapr8coqAAAASZL11ls/I0b8YWkvI4lXVgEAACiQWAUAAKA4YhVol/bYY+fceOPP5tn+\n",
       "97+/lM033zDPPvtMkuTPf/7fHHnkYVl//fXTv/8WOfTQA3PXXSOW9HIBANod71kF2qUZv59swZ+g\n",
       "/tRTdb761SNz8MGH5/TTT81rr72Z++77Q77znROTJNts039JLBUAoF3yyirAfLS0tOT223+Tdddd\n",
       "L3vvvV9WW2219O7dJ3vuuW+2337H/OpXNy7tJQIAvK95ZRXgHXTo0Jhnnnk6//rXP9Pc3DRr++GH\n",
       "H5nJk99aiisDAHj/E6sA89HQ0JCddhqYm2/+Rfbcc2A23njjrLPOetloo09ljTXWXNrLAwB433MZ\n",
       "MMA7WGWVVTNs2NXZfvudMnLkyFx88UU56KD9c9BB+2f06BeW9vIAAN7XxCrQLnXo0DEtLdPn2T59\n",
       "+oxtHTvOuPCkV6/eOe64b+S+++7LsGFX5cADD8lLL43J17/+1SW6XgCA9kasAu1SU1NTJkyYMM/2\n",
       "t7d169YtP/jBeRk58olZ+9ZYY80MHjwk3/rWaXn++Wfzj3/8Y4mtFwCgvfGeVaBdWmONKo899td5\n",
       "tj/22CP50Iea84EPrJCHHvpTJk16M2uu+bE5junatWs6dOiQ7t2b5jkfAIBFQ6wC7dJuu30uBx+8\n",
       "f374wwvymc/snMbGhjzyyF9y+eWXZvDgQ5IkBx00JCeeeFw6duyUffb5XKZMaczTT4/KJZf8MAMH\n",
       "7p6uXZdbys8CAOD9q6GlpWVpryFJWsaOnfdyPJa85uammEUZzGLxe+SRv+SKKy5JXY/MlCmT06fP\n",
       "Ktljj72y4467zDrmwQcfyLXXXpmnnqozceLErLxyr+y4467Zc8990tjonRRLg/82ymEW5TCLcphF\n",
       "WcyjHM3NTQ0Le45XVoF26+MfXy/nnffDBR6z4YYbZ8MNN/Z/dgAAS5iXBQAAACiOWAUAAKA4YhUA\n",
       "AIDiiFUAAACKI1YBAAAojlgFAACgOGIVAACA4ohVAAAAiiNWAQAAKI5YBQAAoDhiFQAAgOKIVQAA\n",
       "AIojVgEAACiOWAUAAKA4YhUAAIDiiFUAAACKI1YBAAAojlgFAACgOGIVAACA4ohVAAAAiiNWAYD/\n",
       "yH33/TGbb77h0l4GAO2EWAUAAKA4YhUAAIDidFzaCwAA3ntGj34hJ510YR588KFMnvxWevfuk8MO\n",
       "+3I23bRfkmSPPXbO3nvvl9/85pY899wzWWONKsccc2zWWGPNJMkrr/w7F154bh588IG88cbrWXHF\n",
       "D+fznx+cHXfcJUlyxBFD8olPbJCnnqrz4IMPpEeP5TN48CHZaaeBS+05A7BkeWUVAFhoxx13TJqa\n",
       "mnLppT/J8OHX5iMf+WhOP/3bmTp16qxjLrnkh9ltt8/miiuuSe/eq2To0CMyfvz4JMkpp3wz48a9\n",
       "lgsu+FGuvvqG9Ou3Rb7//TPy6quvzjr/mmuuzKc+tVmuvvqGbLHFVjn77DPz6quvLPHnCsDSIVYB\n",
       "gIUyadKk7LzzoJx00knp02eVrLJK3+y1134ZN+61WTHZ0NCQnXYamB133CWrrNI3xx77jTQ2dsjd\n",
       "d/82SbLZZpvna187IR/5yEfTq1fvfP7zgzN16tSMHv38rMfZYINPZuDA3dOz58oZMuTwTJ06NaNG\n",
       "PbVUnjMAS57LgAGAhdKlS5cMGrRH7rjjjjz44MN58cXRqeuRaWhoyLRp02cdt956n5j1dadOnfLR\n",
       "j66eZ555OkkyaNBnc/fdI/LTn16d0aNH56mn6iTJ9Okzzm9oaEjv3qvMOr9r1+WSZI5XbgF4fxOr\n",
       "AMB8vfLKvzNhwoSsumrfJElLS0saGxvz5ptv5rDDDsxyy3XNJptskX79tkiXLsvmyCMPm+P8jh3n\n",
       "/GfGtGnT0qFDx7S0tGTo0C/n5Zf/lW233S4bbLBR+vZdLfvuu8ccx3fqNL9/prQsyqcIQMHEKgAw\n",
       "X9dee1Xq+olceOHFSZI33ng9yy+/fP70p/szevQL+d///d+MG/dWkuSuu0bMPOv/YnLkyCeyySYz\n",
       "PnDprbcm5emnR2X77XdMXY/Mww8/mJ/97Ffp2XPlJMnjjz824+wWMQrADGIVAJiv9df/ZG688frc\n",
       "f/+96dmzV66//ppstNEm+dCHVsyUKVPym9/8Jv/1X2ulrkfmxz++MEkyefLkJDOi8/rrr81HPvJf\n",
       "WXXV1TJ8+GXp0qVLttpq20yYMD6NjY2588470r//9hk9+vlccME5aWxszJQpU2adr1sB2jexCrCY\n",
       "TJz4Rq66anh+//u78q9//TMrrPChbLXV1vnCFw7Kcst1y2mnfStvvvlmTj31zPmeP2zYxbn//vty\n",
       "2WVXLuGVwwybbtovn//84Jx11ul5/fXX86lPbZovf3lounfvniFDvpjvf//7GT9+fNZdd72cfvr3\n",
       "MnTol1PXT2SVVVZNQ0NDdt55YC6//NKMGTM66677iZx//o+y336fzT//+Y+0tLTk4osvysUXX5Rk\n",
       "xntU11zzY6nrJ7LRRp9KQ0NDGhqW8jcAgKWqoZDLbVrGjp2wtNdAkubmpphFGcyiLAs7j9dffz2H\n",
       "HTY4TU3dMnjwkPTps2qef/65XHTReVl22a658MKL873vnZ5JkybllFO+O9/7ePPNNzNlypR07959\n",
       "UT2N9wX/bZRjQbP47Gd3yeDBQ7LDDjvNs33XXXeb9ftUZ/eBD6ywWNbZHvjvohxmURbzKEdzc9NC\n",
       "/wjSK6sAi8GPf3xhGhqS8877UTp37pwkWWmlnunbd7Xstdeg3HbbLWloaFjg+/OWXXbZLLvssktq\n",
       "ybDEdO26nDAF4F2JVYBFbPLkyRkx4vYcfviRs0L1bR/+8Eq58MKLs8oqffO3vz2at96alDPO+E5+\n",
       "//u70qnTMhk4cPccfPCMT1Sd/TLghx9+KCeddFy+/OWhueyyH+fVV1/J+ut/MieccPKsf/T/9re3\n",
       "5ZprfpLRo19Ip06dsv76n8yxx35DFPCeMWzYxXn88b+lpWV6Hn/8sRx99Ney5ZZb56KLzs+9996T\n",
       "1157NSus8MEMGrRH9t//wCTJaad9K126LJtJk97MPff8Lp07d87uu38uBxxwcJIZvwrnyisvz69/\n",
       "/cuMHz8+a621doYOPW7WJxzfdtst+clPLs/LL/8rq6zSN4ccctisD4UCYOlqXNoLAHi/eemlMZk4\n",
       "cWLWWmvt+e5fZ511071797S0tOR//ue/09y8YoYPvy6HHfal/OQnw/Lggw/MOnb29+y9/vrr+fWv\n",
       "f5kzzvh+zj//xxk58olceeUVSZJHH30kZ5zxney77xdy3XU35Ywzzs6TT9az9sOSdsMNN89zCfDb\n",
       "FnRFwZ/+dH/WX/+TueSS4fnUpzbLBReck8cffyzf/e7Zue66m7LHHnvlkkt+mKeeenLWObfc8sv0\n",
       "7Llyhg+/NnvttW+GDbt41v4rrrg0P//59TnqqK/miiuuyQc/+KF87WtHZfr06XnggftzwQXnZMiQ\n",
       "L+bKK6/PrrvulhNPPC6PPfboov1mANAqYhVgEZswYXySZLnlur3rsf/1X6vn4IMPS8+eK2ennQam\n",
       "V6/ec/wjfPZ/00+fPj1HHHF0Vl+9yjrr/L8MGLBDRo78W5Kkc+fOOe64EzNgwA758IdXyvrrfzL9\n",
       "+m2RZ555etE+OWijlpaWXHTReenff4s5/jzyyF+SJF26dMl++x2QVVbpm+WXXz7rrvvxfP3rJ2XN\n",
       "NddKz54rZ5999s+yy3bNs8/+39/t3r37ZPDgIVl55V7Zd98vpHv37hk58vG0tLTkF7/4eQ488OBs\n",
       "scWn07t3nwwdely23HLrTJgwPldddUX22Wf/bL31tll55V7ZddfdMmDAZ3L99dcsrW8PALNxGTDA\n",
       "Itajx/JJkgkT3v0DHXr16jXH7W7dmjJ58lvveHzv3qvM+rpr166ZOnVqkmSNNdbMsst2zfDhl+W5\n",
       "557N888/m2eeeTof//gnWvMUYLFpaGjI/vsfmAEDdphj+4c+1JyHHnogK63Uc47tO+ywU+699w+5\n",
       "/fZbM3r0C3nqqSfz5psTM23atFnH9O7dZ45zunZdLlOnTs1rr72WceNey5pr/t9VDt26dcuXvnRU\n",
       "kuTZZ5/O44//bY4rEKZNm5o+fVZdZM8XgNYTqwCLWK9evdO9e/c8/vhjWXPNj82z/7zzvp+ePXvO\n",
       "/NUc817gsqBLJDt16jTXsTP+98EHH8hxxw3NttsOyHrrrZ/PfW7v/Pa3t+fpp59q25OBxaBHj+XT\n",
       "q1fv+e7r3LnLHLdPP/3beeihP2X77XfMdtvtmKFDj8+BB+4zxzEdOsz7z5mWlpYss0ynWV/Pz7Rp\n",
       "03PYYUdks802f9f7A2DJcxkwwCLWoUOH9O+/fW688fq89dacr5K++OLo/PrXv5jng5da6+33tN5w\n",
       "w0+zzTb9c8IJJ2fgwN2z1lrr5MUXX1gkjwFLy7hxr+W2227JiSd+O0OGfDHbbNM/nTp1zBtvvP4f\n",
       "nb/cct3/4VPQAAAdeElEQVTygQ+skLp+Yta2t96alF122S5PPPG39O27Wl56aUx69eo968+IEbfn\n",
       "zjtvX1xPCYCFIFYBFoMDDzwk06ZNy9FHH54HH3wgL700Jvfcc3eGDj0ia665Vnbccdf5vtqzsL/7\n",
       "+u3DV1xxxTz++GN58smReeGF53PxxRfl4YcfyuTJkxfF04GlYrnluqVr1665556789JLY/LXv/4l\n",
       "J554bDp27DjPD4Leyec+t3euvHJY7r//3rzwwvM566zT0q1bt6y+epV99vl8br75pvzylz/PmDEv\n",
       "5le/uinDh1/2jq/6ArBkuc4FYDHo0WP5/OhHwzJ8+GU566zT88orL6e5ecVss82A7L//genUqdPM\n",
       "y4Dn/P3Ys9+esX/+++bef9BBh+aMM76TL31pSLp06ZIBA7bPiSd+J2eddWqmTJkyz+XDUKK5/853\n",
       "7NgxJ598Wi666Lz8+te/TJ8+q+aAAw7K3XffmSefHDnbOe/8e+b33nv/TJw4Md/97qmZOHFiPv7x\n",
       "9fK9752fjh07ZostPp1jjjk21157ZS644Jz07Llyjj32G9lqq20X91MF4D/QsLA/xV9MWsaOffcP\n",
       "ImHxa25uilmUwSzKYh7lMItymEU5zKIcZlEW8yhHc3PTO/9k8R24DBgAAIDiiFUAAACKI1YBAAAo\n",
       "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\n",
       "jj/+JDZv3sxnP7sPF1106RbHe+KJR5k9exarVv2J+vp+HHvsUK655nr69u3Ls8/OYdasmZx88peZ\n",
       "OfMx1q1bx9ChJ3Dddd+lb9++ADz//FweeGAKq1evYujQE6itraVPnz4VfU4kSZLKzQWWJAm2eebz\n",
       "xRdfZMOG9UyZMp2rrrqG2bOf4qWXfgHA/PnPcd99P+Kyy/6FadMepq6ujhdemNfu8tyW288/P5cH\n",
       "H5zK2LHjmTFjNhMm3MTChS/yzDNPt+67cuUKli1bSmPjZG6++fZ240uWLGbixJs4++xzmD79cQYP\n",
       "3ov585/b3k+HJElSr/PMqqSq19zczKRJd/OTn/y43faamhoefvgJAOrr6xk37lrq6urYe+/PMHPm\n",
       "4yxf/juOP/5EnnrqCUaOPIthw74KwLe/PYFXXvn1Vh9rt91244Ybvs8xxwwFYPfd9+Cww4bwxhsr\n",
       "W/fZtGkT1157AwMHDmSffT7HUUcdw/LlrwHw05/O4ktfOpEzzxwFwJgx32Lx4pe37xMiSZKUAcOq\n",
       "pKpXU1PD6NEXtobNtnbbbRAAe+65J3V1H/+X2b9/fzZt2gTA66+vYNSor7eO1dXVccABB7U7TsuZ\n",
       "2yFDjiSl5Uydeh9vvvk/vPHGSt588w+ceurw1n379evHwIED2/zcn40bNwKwcuXrfOUrp7U79sEH\n",
       "H8q6dWu79XeXJEnKlWFVkoABA3Zhr7327nB8658JLQTQuro6mpqa2o+UXFbcchnws8/O4Y47bmP4\n",
       "8BEcffSxnH/+xUybNnmbj9VyvNramtbHbdE2REuSJO0o/MyqJPXQ5z+/b+tlugCbN2/m979PW913\n",
       "xoxHOPfcf2b8+OsYPnwE++67H3/845tdeKz9WLbs1Xbbli//XfcmLkmSlDHfjpckYO3atbz77jtb\n",
       "bO9old22Z07PPvtcbrnlRiIO5IADDmDmzBmsWvXndgsstew/aNDuLFmymFNOGUZTUxMzZz7G22+/\n",
       "xb777tfp/FruP2rUOVxxxcU89thDDB16AgsWzGfp0t8yePBeXf47S5Ik5cywKknAlCmTmDJl0hbb\n",
       "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\n"
      ],
      "text/plain": [
       "<matplotlib.figure.Figure at 0x2fd5aa20>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "from sklearn.decomposition import PCA\n",
    "\n",
    "words = ['US', 'China', 'Japan', 'England', 'France', 'Germany', 'Soviet']\n",
    "word_vectors = [model[word] for word in words]\n",
    "\n",
    "# create and apply PCA transform\n",
    "pca = PCA(n_components=2)\n",
    "principal_components = pca.fit_transform(word_vectors)\n",
    "\n",
    "# slice the 2D array\n",
    "x = principal_components[:, 0]\n",
    "y = principal_components[:, 1]\n",
    "\n",
    "# plot with text annotation\n",
    "fig, ax = plt.subplots(figsize=(16,12))\n",
    "ax.scatter(x, y, s=0)\n",
    "\n",
    "for i, label in enumerate(words):\n",
    "    ax.annotate(label, (x[i], y[i]), size='x-large')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "They're a bit more spread out than I thought they would be, but a few (such as U.S. and China) are very close.  These probably appeared frequently in the text so there may have been a larger amount of training data for these terms.  The results become more interesting when applied to very large datasets, and indeed Google and others have done just that.  In fact, applying this methodology to words is only the beginning.  It's already been extended or is being extended to phrases and even entire documents.  It's a very promising research area and I'm excited to see what comes out of it in the next few years."
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 2",
   "language": "python",
   "name": "python2"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 2
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython2",
   "version": "2.7.9"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 0
}
